Add GtkStyleProperties to the docs

diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index bb9f0cd7fc9e34a4d789e0163cc5750d93e3205c..5214878f873bb77744e77ae3cacbc12191254eb1 100644 (file)
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -55,6 +55,7 @@
     <title>Theming in GTK+</title>
     <xi:include href="xml/gtkwidgetpath.xml" />
     <xi:include href="xml/gtkstyleprovider.xml" />
+    <xi:include href="xml/gtkstyleproperties.xml" />
     <xi:include href="xml/gtkstylecontext.xml" />
     <xi:include href="xml/gtkcssprovider.xml" />
     <xi:include href="xml/gtkthemingengine.xml" />

diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml
index 4f37bace74a6b5b27cb89dff3466479eef4321ee..24b4d335af8a5dc82746ded7d25bcc0f56e86ff7 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkenums.sgml
+++ b/docs/reference/gtk/tmpl/gtkenums.sgml
@@ -313,6 +313,19 @@ Used to change the appearance of an outline typically provided by a #GtkFrame.
 @GTK_SHADOW_ETCHED_IN: The outline has a sunken 3d appearance.
 @GTK_SHADOW_ETCHED_OUT: The outline has a raised 3d appearance
 
+<!-- ##### ENUM GtkStateType ##### -->
+<para>
+
+</para>
+
+@GTK_STATE_NORMAL: 
+@GTK_STATE_ACTIVE: 
+@GTK_STATE_PRELIGHT: 
+@GTK_STATE_SELECTED: 
+@GTK_STATE_INSENSITIVE: 
+@GTK_STATE_INCONSISTENT: 
+@GTK_STATE_FOCUSED: 
+
 <!-- ##### ENUM GtkToolbarStyle ##### -->
 <para>
 Used to customize the appearance of a #GtkToolbar. Note that 

diff --git a/gtk/gtkstyleproperties.c b/gtk/gtkstyleproperties.c
index 3adad1f373786a5f46f64b3572308b5d271165ca..5c54b21da88229efac890eafd9a758c9d23c20e2 100644 (file)
--- a/gtk/gtkstyleproperties.c
+++ b/gtk/gtkstyleproperties.c
@@ -32,6 +32,25 @@
 #include "gtk9slice.h"
 #include "gtkintl.h"
 
+/**
+ * SECTION:gtkstyleproperties
+ * @Short_description: Store for style property information
+ * @Title: GtkStyleProperties
+ *
+ * GtkStyleProperties provides the storage for style information
+ * that is used by #GtkStyleContext and other #GtkStyleProvider
+ * implementations.
+ *
+ * Before style properties can be stored in GtkStyleProperties, they
+ * must be registered with gtk_style_properties_register_property().
+ *
+ * Unless you are writing a #GtkStyleProvider implementation, you
+ * are unlikely to use this API directly, as gtk_style_context_get()
+ * and its variants are the preferred way to access styling information
+ * from widget implementations and theming engine implementations
+ * should use the APIs provided by #GtkThemingEngine instead.
+ */
+
 typedef struct GtkStylePropertiesPrivate GtkStylePropertiesPrivate;
 typedef struct PropertyData PropertyData;
 typedef struct PropertyNode PropertyNode;